RegisterCallback

注册一个当新数据进入时 KINGSTAR 子系统将呼叫的函式。

语法

KsError RegisterCallback(
     AppCallback callback,
     PVOID context
);

参数

callback：每一周期将呼叫的回呼函式指标。请见 AppCallback 类型。

context：若需要，传递给回呼函式的指标。

回传值

如果此函式执行成功，会回传 errNoError，否则会传回错误码。如需更多有关错误码的资讯，请参阅 KsError 清单。

备注

• 注册回呼为非必要，可在应用程式使用自己的周期执行绪。
• 因 RegisterCallback 之即时功能性，其仅可在 RT 介面使用，在其他介面呼叫此函式将会出现 errWrongEnvironment 错误。

可用的 EtherCAT 状态

ecatOP

范例

/*
*    Assume that there is already a callback function in namespace userApp:
*    namespace userApp
*    {
*        int callBack(PVOID Context)
         {
*            return 0;
*        }
*    }
*
*    You can pass the function pointer as an argument:
*/
AppCallback callBack = userApp::callBack;
nRet = RegisterCallback(callBack, NULL);

/*
*    Or you can decay a lambda function to a function pointer (C++11):
*/
nRet = RegisterCallback([](PVOID Context){ return 0; }, NULL);

使用需求

参见

Create

RegisterMailboxCallback

Start